home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / SCSL / scopy.z / scopy
Encoding:
Text File  |  2002-10-03  |  13.0 KB  |  265 lines

  1.  
  2.  
  3.  
  4. SSSSCCCCOOOOPPPPYYYY((((3333SSSS))))                                                            SSSSCCCCOOOOPPPPYYYY((((3333SSSS))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      SSSSCCCCOOOOPPPPYYYY, DDDDCCCCOOOOPPPPYYYY, CCCCCCCCOOOOPPPPYYYY, ZZZZCCCCOOOOPPPPYYYY - Copies a real or complex vector into another
  10.      real or complex vector
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      Single precision
  14.  
  15.           Fortran:
  16.                CCCCAAAALLLLLLLL SSSSCCCCOOOOPPPPYYYY ((((_n,,,, _x,,,, _i_n_c_x,,,, _y,,,, _i_n_c_y))))
  17.  
  18.           C/C++:
  19.                ####iiiinnnncccclllluuuuddddeeee <<<<ssssccccssssllll____bbbbllllaaaassss....hhhh>>>>
  20.                vvvvooooiiiidddd ssssccccooooppppyyyy((((iiiinnnntttt _n,,,, ffffllllooooaaaatttt *_x,,,, iiiinnnntttt _i_n_c_x,,,, ffffllllooooaaaatttt *_y,,,, iiiinnnntttt _i_n_c_y))));;;;
  21.  
  22.      Double precision
  23.  
  24.           Fortran:
  25.                CCCCAAAALLLLLLLL DDDDCCCCOOOOPPPPYYYY ((((_n,,,, _x,,,, _i_n_c_x,,,, _y,,,, _i_n_c_y))))
  26.  
  27.           C/C++:
  28.                ####iiiinnnncccclllluuuuddddeeee <<<<ssssccccssssllll____bbbbllllaaaassss....hhhh>>>>
  29.                vvvvooooiiiidddd ddddccccooooppppyyyy ((((iiiinnnntttt _n,,,, ddddoooouuuubbbblllleeee *_x,,,, iiiinnnntttt _i_n_c_x,,,, ddddoooouuuubbbblllleeee *_y,,,, iiiinnnntttt _i_n_c_y))));;;;
  30.  
  31.      Single precision complex
  32.  
  33.           Fortran:
  34.                CCCCAAAALLLLLLLL CCCCCCCCOOOOPPPPYYYY ((((_n,,,, _x,,,, _i_n_c_x,,,, _y,,,, _i_n_c_y))))
  35.  
  36.           C/C++:
  37.                ####iiiinnnncccclllluuuuddddeeee <<<<ssssccccssssllll____bbbbllllaaaassss....hhhh>>>>
  38.                vvvvooooiiiidddd ccccccccooooppppyyyy ((((iiiinnnntttt _n,,,, ssssccccssssllll____ccccoooommmmpppplllleeeexxxx *_x,,,, iiiinnnntttt _i_n_c_x,,,, ssssccccssssllll____ccccoooommmmpppplllleeeexxxx *_y,,,,
  39.                iiiinnnntttt _i_n_c_y))));;;;
  40.  
  41.           C++ STL:
  42.                ####iiiinnnncccclllluuuuddddeeee <<<<ccccoooommmmpppplllleeeexxxx....hhhh>>>>
  43.                ####iiiinnnncccclllluuuuddddeeee <<<<ssssccccssssllll____bbbbllllaaaassss....hhhh>>>>
  44.                vvvvooooiiiidddd ccccccccooooppppyyyy ((((iiiinnnntttt _n,,,, ccccoooommmmpppplllleeeexxxx<<<<ffffllllooooaaaatttt>>>> *_x,,,, iiiinnnntttt _i_n_c_x,,,, ccccoooommmmpppplllleeeexxxx<<<<ffffllllooooaaaatttt>>>>
  45.                *_y,,,, iiiinnnntttt _i_n_c_y))));;;;
  46.  
  47.      Double precision complex
  48.  
  49.           Fortran:
  50.                CCCCAAAALLLLLLLL ZZZZCCCCOOOOPPPPYYYY ((((_n,,,, _x,,,, _i_n_c_x,,,, _y,,,, _i_n_c_y))))
  51.  
  52.           C/C++:
  53.                ####iiiinnnncccclllluuuuddddeeee <<<<ssssccccssssllll____bbbbllllaaaassss....hhhh>>>>
  54.                vvvvooooiiiidddd zzzzccccooooppppyyyy(((( iiiinnnntttt _n,,,, ssssccccssssllll____zzzzoooommmmpppplllleeeexxxx *_x,,,, iiiinnnntttt _i_n_c_x,,,, ssssccccssssllll____zzzzoooommmmpppplllleeeexxxx *_y,,,,
  55.                iiiinnnntttt _i_n_c_y))));;;;
  56.  
  57.           C++ STL:
  58.                ####iiiinnnncccclllluuuuddddeeee <<<<ccccoooommmmpppplllleeeexxxx....hhhh>>>>
  59.                ####iiiinnnncccclllluuuuddddeeee <<<<ssssccccssssllll____bbbbllllaaaassss....hhhh>>>>
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. SSSSCCCCOOOOPPPPYYYY((((3333SSSS))))                                                            SSSSCCCCOOOOPPPPYYYY((((3333SSSS))))
  71.  
  72.  
  73.  
  74.                vvvvooooiiiidddd zzzzccccooooppppyyyy(((( iiiinnnntttt _n,,,, ccccoooommmmpppplllleeeexxxx<<<<ddddoooouuuubbbblllleeee>>>> *_x,,,, iiiinnnntttt _i_n_c_x,,,,
  75.                ccccoooommmmpppplllleeeexxxx<<<<ddddoooouuuubbbblllleeee>>>> *_y,,,, iiiinnnntttt _i_n_c_y))));;;;
  76.  
  77. IIIIMMMMPPPPLLLLEEEEMMMMEEEENNNNTTTTAAAATTTTIIIIOOOONNNN
  78.      These routines are part of the SCSL Scientific Library and can be loaded
  79.      using either the ----llllssssccccssss or the ----llllssssccccssss____mmmmpppp option.  The ----llllssssccccssss____mmmmpppp option
  80.      directs the linker to use the multi-processor version of the library.
  81.  
  82.      When linking to SCSL with ----llllssssccccssss or ----llllssssccccssss____mmmmpppp, the default integer size is
  83.      4 bytes (32 bits). Another version of SCSL is available in which integers
  84.      are 8 bytes (64 bits).  This version allows the user access to larger
  85.      memory sizes and helps when porting legacy Cray codes.  It can be loaded
  86.      by using the ----llllssssccccssss____iiii8888 option or the ----llllssssccccssss____iiii8888____mmmmpppp option. A program may use
  87.      only one of the two versions; 4-byte integer and 8-byte integer library
  88.      calls cannot be mixed.
  89.  
  90.      The C and C++ prototypes shown above are appropriate for the 4-byte
  91.      integer version of SCSL. When using the 8-byte integer version, the
  92.      variables of type iiiinnnntttt become lllloooonnnngggg lllloooonnnngggg and the <<<<ssssccccssssllll____bbbbllllaaaassss____iiii8888....hhhh>>>> header
  93.      file should be included.
  94.  
  95. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  96.      SSSSCCCCOOOOPPPPYYYY/DDDDCCCCOOOOPPPPYYYY copies a real vector into another real vector.
  97.  
  98.      CCCCCCCCOOOOPPPPYYYY/ZZZZCCCCOOOOPPPPYYYY copies a complex vector into another complex vector.
  99.  
  100.      These routines perform the following vector operation:
  101.  
  102.           _y  <- _x
  103.  
  104.  
  105.      where _x and _y are real or complex vectors.
  106.  
  107.      See the NOTES section of this man page for information about the
  108.      interpretation of the data types described in the following arguments.
  109.  
  110.      These routines have the following arguments:
  111.  
  112.      _n     Integer.  (input)
  113.            Number of elements to be copied.  If _n <= 0, these functions return
  114.            without any computation.
  115.  
  116.      _x     Array of dimension (_n-1) * |_i_n_c_x| + 1.  (input)
  117.            SSSSCCCCOOOOPPPPYYYY: Single precision array.
  118.            DDDDCCCCOOOOPPPPYYYY: Double precision array.
  119.            CCCCCCCCOOOOPPPPYYYY: Single precision complex array.
  120.            ZZZZCCCCOOOOPPPPYYYY: Double precision complex array.
  121.            Vector from which to copy.
  122.  
  123.      _i_n_c_x  Integer.  (input)
  124.            Increment between elements of _x.  If _i_n_c_x = 0, the results will be
  125.            unpredictable.
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. SSSSCCCCOOOOPPPPYYYY((((3333SSSS))))                                                            SSSSCCCCOOOOPPPPYYYY((((3333SSSS))))
  137.  
  138.  
  139.  
  140.      _y     Array of dimension (_n-1) *|_i_n_c_y| + 1.  (output)
  141.            SSSSCCCCOOOOPPPPYYYY: Single precision array.
  142.            DDDDCCCCOOOOPPPPYYYY: Double precision array.
  143.            CCCCCCCCOOOOPPPPYYYY: Single precision complex array.
  144.            ZZZZCCCCOOOOPPPPYYYY: Double precision complex array.
  145.            Result vector.
  146.  
  147.      _i_n_c_y  Integer.  (input)
  148.            Increment between elements of _y.  If _i_n_c_y = 0, the results will be
  149.            unpredictable.
  150.  
  151. NNNNOOOOTTTTEEEESSSS
  152.      These routines are Level 1 Basic Linear Algebra Subprograms (Level 1
  153.      BLAS).
  154.  
  155.      When working backward (_i_n_c_x < 0 or _i_n_c_y < 0), each routine starts at the
  156.      end of the vector and moves backward, as follows:
  157.  
  158.           _x(1-_i_n_c_x * (_n-1)), _x(1-_i_n_c_x * (_n-2)), ..., _x(1)
  159.  
  160.           _y(1-_i_n_c_y * (_n-1)), _y(1-_i_n_c_y * (_n-2)), ..., _y(1)
  161.  
  162.    DDDDaaaattttaaaa TTTTyyyyppppeeeessss
  163.      The following data types are described in this documentation:
  164.  
  165.           TTTTeeeerrrrmmmm UUUUsssseeeedddd                     DDDDaaaattttaaaa ttttyyyyppppeeee
  166.  
  167.      Fortran:
  168.  
  169.           Array dimensioned _n           xxxx((((nnnn))))
  170.  
  171.           Character                     CCCCHHHHAAAARRRRAAAACCCCTTTTEEEERRRR
  172.  
  173.           Integer                       IIIINNNNTTTTEEEEGGGGEEEERRRR (IIIINNNNTTTTEEEEGGGGEEEERRRR****8888 for ----llllssssccccssss____iiii8888[[[[____mmmmpppp]]]])
  174.  
  175.           Single precision              RRRREEEEAAAALLLL
  176.  
  177.           Double precision              DDDDOOOOUUUUBBBBLLLLEEEE PPPPRRRREEEECCCCIIIISSSSIIIIOOOONNNN
  178.  
  179.           Single precision complex      CCCCOOOOMMMMPPPPLLLLEEEEXXXX
  180.  
  181.           Double precision complex      DDDDOOOOUUUUBBBBLLLLEEEE CCCCOOOOMMMMPPPPLLLLEEEEXXXX
  182.  
  183.      C/C++:
  184.  
  185.           Array dimensioned _n           xxxx[[[[_n]]]]
  186.  
  187.           Character                     cccchhhhaaaarrrr
  188.  
  189.           Integer                       iiiinnnntttt (lllloooonnnngggg lllloooonnnngggg for ----llllssssccccssss____iiii8888[[[[____mmmmpppp]]]])
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. SSSSCCCCOOOOPPPPYYYY((((3333SSSS))))                                                            SSSSCCCCOOOOPPPPYYYY((((3333SSSS))))
  203.  
  204.  
  205.  
  206.           Single precision              ffffllllooooaaaatttt
  207.  
  208.           Double precision              ddddoooouuuubbbblllleeee
  209.  
  210.           Single precision complex      ssssccccssssllll____ccccoooommmmpppplllleeeexxxx
  211.  
  212.           Double precision complex      ssssccccssssllll____zzzzoooommmmpppplllleeeexxxx
  213.  
  214.      C++ STL:
  215.  
  216.           Array dimensioned _n           xxxx[[[[_n]]]]
  217.  
  218.           Character                     cccchhhhaaaarrrr
  219.  
  220.           Integer                       iiiinnnntttt (lllloooonnnngggg lllloooonnnngggg for ----llllssssccccssss____iiii8888[[[[____mmmmpppp]]]])
  221.  
  222.           Single precision              ffffllllooooaaaatttt
  223.  
  224.           Double precision              ddddoooouuuubbbblllleeee
  225.  
  226.           Single precision complex      ccccoooommmmpppplllleeeexxxx<<<<ffffllllooooaaaatttt>>>>
  227.  
  228.           Double precision complex      ccccoooommmmpppplllleeeexxxx<<<<ddddoooouuuubbbblllleeee>>>>
  229.  
  230. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  231.      IIIINNNNTTTTRRRROOOO____SSSSCCCCSSSSLLLL(3S), IIIINNNNTTTTRRRROOOO____BBBBLLLLAAAASSSS1111(3S)
  232.  
  233.      IIIINNNNTTTTRRRROOOO____CCCCBBBBLLLLAAAASSSS(3S) for information about using the C interface to Fortran 77
  234.      Basic Linear Algebra Subprograms (legacy BLAS) set forth by the Basic
  235.      Linear Algebra Subprograms Technical Forum.
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.                                                                         PPPPaaaaggggeeee 4444
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.